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Preface 


This manual describes the setup files for the C shell command interpreter, and the 
interactive editor vi. Each of these files is read in automatically by the appropri¬ 
ate program, and contains commands and instructions to set up (or disable) vari¬ 
ous features of that program. 

In this manual, the term environment is loosely defined as the various options and 
features that affect how the system or interactive program responds to you. 

There is a sample of each setup file and a line-by-line explanation of its contents. 
Culled from a variety of expert users, these files contain some very convenient 
combinations of features and commands. Most importantly, these samples pro¬ 
vide a starting point from which you can begin tailoring the system to your 
specific needs and style. 

Chapter 1 is an overview of various setup files and a description of how they are 
used by the interactive programs. 

Chapter 2 describes the . cshrc file for the C shell. 

Chapter 3 describes the . login file for the C shell. 

Chapter 4 describes the , logout file for the C shell. 

Chapter 5 describes the . exrc file for vi (and the line editor ex). 

Online copies of the sample files are located in: 

.cshrc /usr/lib/Cshrc 

.login /usr/lib/Login 

.logout /usr/lib/Logout 

.exrc /usr/lib/Exrc 


Prerequisite Documents You should be familiar with the contents of the following manuals before you 

read this one (this is a suggested reading order): 

Getting Started with SunOS: Beginner’s Guide 

SunView 1 Beginner’s Guide 

Mail and Messages: Beginner’s Guide 

Setting Up Your SunOS Environment: Beginner’s Guide 



Preface — Continued 


Companion Documents 


You should also read the following manuals: 
Doing More with SunOS: Beginner’s Guide 
Self-Help with Problems: Beginner’s Guide 
SunOS Reference Manual 



Overview 


Overview. 3 

1.1. The SunOS Environment. 3 

1.2. Interactive Programs and Setup Files. 3 

1.3. Installing the Setup Files In Your Home Directory. 4 

1.4. Setting Up Your Terminal. 5 

1.5. The File System Hierarchy. 7 




Overview 


If you have been reading through the other Beginner’s Guides, and have been 
using the system for a while, you have probably discovered features that you like 
and features you would like. The interactive programs that you have used so far 
have many optional features that you may not know about. This manual 
describes a number of these features, and how set things up so that you get the 
features you want automatically. 


1.1. The SunOS When working with the system, the interactive program that is currently running 

Environment on your terminal provides a context in which you accomplish your work. When 

you first log in, you are said to be "in" the command interpreter or shell. When 
you change directories, you are said to be "in" a new one. When using the text 
editor, you are said to be "in" vi. 

While in the shell, you t5T)ically run the commands described in the SunOS 
R^erence Manual. When in vi, you typically use text editing commands to 
read and modify files, as described in Getting Started with SunOS: Beginner's 
Guide While in mail or Mail Tool, you typically use commands to read and 
dispose of messages, or to compose and post messages. 

Actually you are probably in your office while all this computing activity is 
going on, but the metaphor is helpful. 

In keeping with this analogy you can think of the environment as characteristics 
of the system and the current interactive program that affect the way you work. 


The technical meaning with respect 
to SunOS is more restricted: the 
environment is a body of information 
that is inherited from the "parent" of 
a process (program currently run¬ 
ning). For example, the name of 
the current directory is passed 
aiong when you start vi, so it 
appears that you "stay in the same 
directory." See Doing More with 
SunOS: Beginner’s Guide for more 
information about processes. 


When you change interactive programs (by entering mail for instance), some 
characteristics, such as the commands that are accepted, also change. Others, 
such as the current working directory, may not. But most importantly, you usu¬ 
ally wish to perform different sorts of tasks, so your expectations about what is a 
proper response from the system also change. 


1.2. Interactive Programs 
and Setup Files 


The interactive programs that you use most often, such as the C shell command 
inteipreter, mail, and vi, each have a variety of optional settings that affect the 
way they respond to your commands. Unlike options that you type in on the 
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4 Setting Up Your SunOS Environment 


command line (such as Is -t), you typically select interactive features by typ¬ 
ing in commands while you are using that program.^ 

To save you time, most interactive programs allow you to put a list of commands 
(to select features that you normally want in effect) in a setup file in your home 
directory. Each program reads its setup file(s) automatically and perfonns the 
commands it contains. 

Subsequent chapters present samples of the various setup files for vi and the C 
shell command interpreter. Each file is described command by command. 


The .mailrcFile 


1.3. Installing the Setup 
Files In Your Home 
Directory 


There is another file, called .mailrc, which modifies the behavior of mail and 
Mail Tool. Although it is similar to the other setup files discussed here, it is 
covered in the manual Mail and Messages: Beginner’s Guide. 

The sample files described in this manual are located in the directory 
/usr/lib, and you can copy them to your home directory. But before you do, 
check to see if there are setup files already present: 


Figure 1-1 Checkfor These Files 


r . ■ . ' ' ' .. , 1 . 

venus % cd 

venu5% l3 «c3hrc ♦exrc .login .logont 
.cshrc not found 
.exrc not found 
.login not found 


.logout not found 


vcnus% 


V _ 

j 


CAUTION If one or more of these files are present in your home directory, check with 
your System Administrator before you copy the samples. 

To copy the setup files, type in these commands: 

Figure 1-2 Installing Set-Up Files 

- - ^— - ^ 

cp /usr/lib/Cshrc .cshrc 

cp /usr/lib/Exrc .exrc 

cp /usr/lib/Login .login 

cp /usr/lib/Logout .logout 

V._ 

Once copied, you can modify them as you like using vi, or any other text editor. 

These samples have been culled from the setup files of a variety of expert users. 
They contain many useful features and ideas. Even so, you will want to edit 
them to suit your own personal needs and tastes, and to remove references to 
features that you don’t want. Generally speaking, the smaller the setup file is, the 


^ Most interactive commands also have command-line options that you can specify. Refer to the entiy for 

the cOTimand of interest in the SunOS Reference Manual for informaticBi abcHit its cx)mmand-line onions. 
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faster the program will start up. 

Underlying all of these considerations is the terminal you are using, and its 
characteristics. As indicated in Getting Started with SunOS: Beginner’s Guide 
you can assign terminal functions such as erase and kill (erase the entire line 
typed in so far) to control keys such as I Del 1 and 1 Back Space 1 .^ 

The command st t y provides you with a means to set up these and other termi¬ 
nal characteristics. To find out what your current terminal characteristics are, 
type in the command: 

stty everything 

This gives you a list of aU terminal characteristics currently in effect. 

Figure 1-3 Viewing All Terminal Characteristics 


1.4. Setting Up Your 
Terminal 



vsnus% stty everything 
new tty, speed 9600 baud 

even odd “raw “nl echo -lease -tandem tabs -ebreak 
ert: (ertbs erterase crtklll ctlecho) -tostop 
-tilde -flusho -mdmbuf -litout -nohang 
-pendin decctlq -noflsh 

erase kill werase rprnt flush Inext susp intr 

"U 'W "R -Q "V “Z/'Y "C 


The command 
stty all 

displays a shorter list. For now, you can ignore all but the the last two lines,^ 
which describe terminal-control functions and the keys they are set to. These are 
described below: 

Figure 1-4 Selected Terminal Characteristics 



venus% stty 
;.n-ew 

ert 

all 

jed 9600 bau 



.‘. 

Cox; xg• 

erase . kill 


rnt flush Inext susp 

intr quit stop 

' • eof 


-W -R 


-C " -S/"Q 

•. ■ . •••■<■• J 


erase 

Erase character. Backspace and erase one character. This is the [Dell key 
by default on some keyboards. On others, this function is assigned to the 

^ If you are using SunView on the Sun Workstation, you can assign commands and functions to the special 
functiem keys cm the Sun Workstation keyboard. See SunView 1 Beginner*s Guide for details. 

3 For more information about the remaining terminal characteristics, refer to stty in the SunOS Reference 
Manual. 
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6 Setting Up Your SunOS Environment 


(Back Space I key. 
kill 

Kill the whole line. Erase the entire command line typed in so far. 
werase 

Delete word. Erase the rightmost word typed in so far (back to a space or 
tab); usually assigned to I Ctrl-W I . 

rprnt 

Reprint. Reprint the line typed in so far. This is useful when you type ahead 
and the prompt gets displayed in the middle of your text. 

flush 

Wait for a keystroke. Stops terminal output until you press a key. 

Inext 

Literal next-character. Interprets the next (control) character as literal text. 

SUSP 

Suspend the program. Temporarily halts execution of the program currently 
running and puts it in the background. To resume execution of the com¬ 
mand, type %.‘^ When you type the suspend character, usually f Ctrl-Z 1 . in the 
middle of a C shell command-line, the shell ignores that line and issues a 
new prompt. 

intr 

Interrupt. Interrupt the program currently running, 
quit 

Halt the current program and leave a binary image in a file called core, 
stop 

Stop the display. To resume, press I Ctrl-0 1 . 

eof 

End-of-file. Send the program an end-of-file character. 

To assign any of these functions to another control key, supply the function, a 
space and the circumflex character ("), followed by the new key, as an arguments 
to stty. 


Figure 1-5 


Using stty 


vehus% stty erase 



This avoids problems trying to type in a key that is already assigned. 
To assign erase to the f Back Space I key, use the command: 
stty erase “h 


C shell only. 
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Chapter 1 — Overview 7 


To assign werase to the (Dell key,use: 
stty werase ''? 

To assign kill to the I Esc I key, use; 
stty kill ~[ 

Chapter 3 has more information about setting up terminal characteristics. For a 
description of other terminal characteristics that you can set up, refer to stty in 
the SunOS Reference Manual. To assign commands to the special function keys 
on the workstation keyboard, refer to SunView 1 Beginner’s Guide 

1.5. The File System As mentioned above, the file system’s directory hierarchy is a part of the 

Hierarchy "landscape" that you will want to become familiar with. You can see an example 

of a typical SunOS hierarchy by typing man hier or by looking under hier in 
Section 7 of the SunOS Reference Manual. 
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The C Shell and the . cshrc File 


The C shell is one of the two command interpreters available on the Sxm Work¬ 
station, and the one that we recommend for interactive use. Whenever you start 
running the C shell, such as when you log in or open a terminal ( shelltool) 
window, the C shell looks for the . cshrc file in your home directory for its ini¬ 
tial instmctions. You can include in this file any command that you might ordi¬ 
narily type on the command line. 

The name is derived from csh, which is the program that uses it. The rc suffix 
is derived from the term "ran command." Setup files ending in this suffix are 
read at the time you run the command. The "dot" at the beginning of the 
filename indicates that this file is to remain hidden from view when you do an 
Is. Setup files are rarely of interest unless you are editing them specifically, and 
in that case you already know the filename and directory location. (To list hid¬ 
den files, use the -a option of Is.) 

2.1. Selecting C Shell While in the C shell, you can use the set command to select the options you 

Features would like. For instance, if you want the C shell to prevent you from acciden¬ 

tally logging out by typing a I Ctrl-D I . you can set the ignoreeof option (or, 
technically speaking, variable): 

Figure 2-1 The set Command 



To turn off an option, use the unset command: 
Figure 2-2 The unset Command 



Some options allow you to supply a specific number or value. For instance, you 
can use the history variable to select the size of the history list; that is, the 
number of previous commands to remember: 


S im 11 Revision A of 9 May 1988 
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Figure 2-3 The history Command 
' ' 

Venus % set history =40 

'-! _ > 

Or, you can alter the prompt that the shell displays: 

Figure 2-4 Changing Your Prompt 

-^ 

venus% set pronqpt = "THIS IS A VERY LONG PROMPT; " 

THIS IS A VERY LONG PROMPT: ■ 

_ ! _ • 


To see what options are currently in effect, and their values (if any) use the set 
command with no arguments: 





-^ 

s®t. 



argv 

0 



cdpat-h 

(. .. /home/sam /home/sam/bin /usr/s 

am/src) 


cwd 

/home/sam/env 



hiatoiy 




horn© 

/home/sam 



ignoreeof 



noclobl?©r 



notify 




pa til 

(. /home/sam. /home/sam/bin /usr/ucb 

/usr/bin /bin} 


prompt 

Venus% 



sh©ll 

/bin/csh 



atatiaa 




term 




user 





You can find descriptions of all C shell options (predefined variables) under csh 
in the SunOS R^erence Manual. (Or type man csh.) 

2.2. A Sample . cshrc The following pages contain an annotated listing of the sample . cshrc file 

File located in/usr/lib/ Cshrc. This is a very large sample file. Many of the 

commands and features it includes may not pertain to you, and we recommend 
that you delete those that you don’t from your copy of the file. 

A number of commands have been "commented out" by placing a pound-sign (#) 
to their left. The C shell will ignore these commands unless you remove the 
pound-sign character. Commands that are listed but commented out are felt to be 
interesting and educational, but not necessarily those that a beginner would use. 
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################################################################# 

# 

# .cshrc file 

# 

# initial setups for both interactive and noninteractive 

# C-Shells 

# 

################################################################# 


# set up search path 


set Ipath = ( ) # add directories for local coinitiands J 

set path = (. ~ ~/bin /usr/local /usr/ucb /usr/bin /bin) 2 

# cd path 

set led = ( -) # add parents of frequently used directories 3 

set cdpath = (.. ~ '/bin ~/src $lcd) 4 

# set this for all shells 

set noclobber 5 

# aliases for all shells 

alias cd 'cd \!*;echo $cwd' 6 

alias cp 'cp -i' 7 

alias mv 'mv -i.' 8 

alias rm 'rm -i' 9 

alias pwd ''echo $cwd'’ lo 

talias del 'rm -i' u 

#umask 002 i2 

# skip remaining setup if not an interactive shell 

if ($?USER == 0 M $?prompt == 0) exit 13 

# settings for interactive shells 

set history=40 u 

set ignoreeof i5 

#set notify i6 

#set savehist=40 i7 

#set prompt="% " is 

#set prompt="'hostname'{'whoami'}\!: " 79 

#set time=100 20 


# commands for interactive shells 


m sun 
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14 Setting Up Your SunOS Environment 


#date 21 

#pwd 22 

# other aliases 

#alias a alias 23 

#alias h 'history \!* I head -39 1 more' 24 

#alias u unalias 25 


#alias 

'"L 

clear 

26 

#alias 

list 

cat 

27 

#alias 

lock 

lockscreen 

28 

#alias 

m 

more 

29 

#alias 

mroe 

more 

30 

#alias 

type 

more 

31 

#alias 


'echo $cwd' 

32 

#alias 

• • 

'set dot=$cwd;cd ..' 

33 

#alias 

f 

'cd $dot ' 

34 

#alias 

dir 

Is 

35 

#alias 

pdw 

'echo $cwd' 

36 

#alias 

la 

'Is -a' 

37 

#alias 

11 

'Is -la' 

38 

#alias 

Is 

1 

CO 

1—j 

39 


#alias 

pd 


dirs 



40 

falias 

po 


popd 



41 

#alias 

pp 


pushd 



42 

#alias 

+w 


'chmod go+w' 



43 

#alias 

-w 


'chmod go-w' 



44 

#alias 

X 


'chmod +x' 



45 

falias 

j 


'jobs -1' 



46 

talias 

bye 


logout 



47 

#alias 

ciao 


logout 



48 

talias 

adios 


logout 



49 

talias 

psg 


'ps -ax 1 grep \!^ I grep -v grep' 



50 

talias 

punt 


kill 



51 

talias 

r 


rlogin 



52 

talias 

run 


source 



53 

talias 

nms 'tbl 

\!* 

1 nroff -ms | more' 

t 

nroff -ms 

54 

talias 

tms 'tbl 

\!* 

1 troff -t -ms >! troff.output 

t 

troff -ms 

55 

talias 

tpr 'tbl 

\ ! * 

1 troff -t -ms 1 Ipr -t &' 

t 

troff & print 

56 
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#alias 

ppr 'Ipr -t 

\!* 


# print troffed 

57 

#alias 

Ipl 

'Ipr -PI' 



58 

#alias 

Iql 

'Ipq -PI' 



59 

#alias 

Irl 

'Iprm -PI' 



60 

#alias 

sd 

'screendump | 

1 rastrepl | 

1 Ipr -V &' 

61 

#alias 

edit 

textedit 



62 

#alias 

help 

man 



63 

#alias 

key 

'man -k' 



64 

#alias 

mkae 

make 



65 
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Explanation of Command Line 1: 

Lines 

set Ipath = ( ) # add directories for local commands 

Creates a variable in which to add the pathnames of directories containing 
local commands. Add the pathnames for any such directories between the' 
parentheses (ask your System Administrator for the appropriate names). 
These directories are incorporated into the path variable in line 3. 

Line 2: 

set path = (. ~ '/bin /usr/local /usr/ucb /usr/bin /bin) 

Sets the path variable to include the standard directories containing SunOS 
commands. 

Line 3: 

set led = ( ) # add parents of frequently used directories 

Creates a variable in which to add the pathnames of directories that are 
parents of those that you often cd to. For instance, if you often cd to 
/usr/man/manl, add put the pathname /usr/man between the 
parentheses. These directories are added to the cdpath variable in the next 
line. 

Line 4: 

set cdpath = (.. ~ '/bin '/sre $lcd) 

Sets the cdpath variable. You need not specify pathnames when you cd 
to directories that are contained in any of those listed. With . . set in your 
cdpath (as above), if you were in /usr/man/manl and you wanted to 
cd to / usr/man/cat 1, you could use the command cd catl to do so. 

Line 5: 

set noclobber 

Prevents unintentional overwrites of files when you use the > symbol. See 
Doing More with SunOS: Beginner’s Guide for details. 

Line 6: 

alias cd 'cd \!*;echo $cwd' 

Displays the new directory when you use cd. to change directories. 

Line 7: 

alias cp 'cp -i' 

Asks for confirmation before overwriting existing files with cp. 

Line 8: 


Asun 
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alias mv 'mv -i' 

Asks for confirmation before overwriting existing files with mv. 

Line 9: 

alias rm ' rm -i' 

Asks for confirmation before removing files. 

Line 10: 

alias pwd 'echo $cwci' 

A fast way of finding out which directory you’re in; faster than the built-in 
pwd command. 

Line 11: 

#alias del 'rm -i' 

A name for rm that is familiar to PC users. 

Line 12: 
fumask 002 

Sets the default permissions mask for new files to allow read and write 
access to the owner’s group as well as to the owner. 

Line 13: 

if ($?USER == 0 I I $?prompt == 0) exit 

Tests to see whether there is a variable called USER, or a variable called 
prompt currently set. If they’re not set, then the shell is non-interactive, so 
the C shell doesn’t bother to process the rest of the commands from this file. 
This saves time running sub-shells. 

Line 14: 

set history=40 

The C shell records the last 40 commands typed in. 

Line 15: 

set ignoreeof 

Prevents accidental logouts when you type I Ctrl-D I . 

Line 16: 

#set notify 

Prevents waiting for display of C shell messages. Normally, the C shell 
waits until just before printing the prompt to print its messages. Commands, 


msun 
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however, don’t always wait to print their messages, so setting notify 
means that all messages will work the same way. 

Line 17: 

#set savehist=40 

When you log out, the C shell saves the last 40 commands, and uses them as 
the starting history list for your next session. 

Line 18: 

#set prompt="% " 

An alternate prompt favored by some SunOS wizards. 

Line 19: 

#set prompt="'hostname'{'whoami'}\!: " 

An alternate prompt favored by some network wizards. This prompt gives 
the name of the machine, followed by the name of the user, followed by the 
history number of the command: 

venus[medici}22: 

Line 20: 

#set time=100 

Display time statistics for commands that take longer than 100 CPU 
seconds. 

Line 21: 

#date 

Display the date and time when the C shell starts up. 

Line 22: 

#pwd 

Display the working directory when the C shell starts up. 

Line 23: 

alias a alias 

Abbreviate the alias command. 

Line 24: 

#alias h 'history \!* | head -39 | more' 

Abbreviate history, and delete the last line (containing h) from the 
display. (Assumes that you have the history variable set to 40, as above.) 
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Line 25: 

#alias u unalias 

Abbreviate the unalias command. 

Line 26: 

#alias "L clear 

The 1 Ctrl-L 1 character is the character often used to begin a new page or 
clear the current one. This alias mimics that behavior. 

Line 27: 

#alias list cat 

A name for cat that is familiar to PC users. 

Line 28: 

#alias lock lockscreen 

An abbreviation for lockscreen. 

Line 29: 

#alias m more 

An abbreviation for more. 

Line 30: 

♦alias mroe more 

A remedy for “fat fingers” (ie., for mistyping the word “more”). 

Line 31: 

♦alias type more 

A name for more that is familiar to PC users. 

Line 32: 

♦alias . 'echo $cwd' 

An abbreviation for pwd. 

Line 33: 

♦alias .. 'set dot=$cwd;cd ..' 

A quick way to change from child directoiy to parent (and back again with 
alias on the next line). 

Line 34: 
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#alias , 'cd $dot ' 

A quick way to change back after using the . . alias above. 

Line 35: 

#alias dir Is 

A name for Is that is familiar to PC users. 

Line 36: 

♦alias pdw 'echo $cwd' 

For those people who often mistype “pwd.” Has the same effect as the . 
alias for pwd, above. 

Line 37: 

♦alias la 'Is -a' 

Abbreviation for command to list all filenames, including those that begin 
with a dot (.). 

Line 38: 

♦alias 11 'Is -la' 

Abbreviation for a command to give a long listing of filenames, including 
those that begin with a dot. 

Line 39: 

♦alias Is 'Is -F' 

This way. Is appends characters on the end of a filename to indicate that 
file’s type. These characters are / (slash) for directories; * for executable 
files; @ for symbolic links; and = for AF_UNIX domain sockets. 

Line 40: 

♦alias pd dirs 

Abbreviation to display the directory stack maintained by pushd and 
popd. See Doing More with SunOS: Beginner’s Guide for details. 

Line 41: 

♦alias po popd 

Change directories to the one on the top of the stack, and remove its name 
from the stack. See Doing More with SunOS: Beginner’s Guide 

Line 42: 

♦alias pp pushd 


&sun 

microsystems 


Revision A of 9 May 1988 



Chapter 2 — The C Shell and the . cshrc File 21 


Change directories, adding the current directoiy and the destination to the 
stack. See Doing More with SunOS: Beginner’s Guide 

Line 43: 

♦alias +w 'chmod go+w' 

Make a file writeable to the group and public. 

Line 44: 

♦alias -w 'chmod go-w' 

Make a file unwriteable to all but you, the owner. 

Line 45: 

♦alias X 'chmod +x' 

Give a file execute permissions for all users. 

Line 46: 

♦alias j 'jobs -1' 

Display the list of background jobs. With -1, the j alias also gives the pro¬ 
cess id number of the stopped job. 

Line 47: 

♦alias bye logout 

Another name for logout. 

Line 48: 

♦alias ciao logout 

An international term for logout. 

Line 49: 

♦alias adios logout 

The traditional South-of-the-Border way to log out 
Line 50: 

♦alias psg 'ps -ax | grep * | grep -v grep' 

Check on the status of a command by its name. See Doing More with 
SunOS: Beginner’s Guide for details. 

Line 51: 

♦alias punt kill 

Another name for kill. 
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Line 52: 

#alias r rlogin 

Log in to another host machine on the net. See Using the Network: 
Beginner’s Guide for details. 

Line 53: 

#alias run source 

The source command instructs the C shell to take a file (such as the 
. cshrc file) as a list of commands to perform. 

Line 54: 

#alias nms 'tbl \!* | nroff -ms | more' 

Format and display a document containing tbl instructions and ms macros 
on the terminal. For example, to format the file wombat, you would type 
nms wombat. 

Line 55: 

#alias tms 'tbl \!* | troff -t -ms >! troff.output &' 

Format a document using tbl and ms macros, and place the output in a file 
for later printing. 

Line 56: 

#alias tpr 'tbl \!* | troff -t -ms | Ipr -t &' 

Format a document using tbl and ms macros and print it. 

Line 57: 

♦alias ppr 'Ipr -t \!* &' 

Print a preformatted troff-output file. 

Une 58: 

♦alias Ipl 'Ipr -PI' 

Abbreviation to print on printer #1. See Doing More with SunOS: 
Beginner’s Guide for details. 

Line 59: 

♦alias Iql 'Ipq -PI' 

Abbreviation to check the queue for printer #1. 

Line 60: 

#alias Irl 'Iprm -Pi' 
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Abbreviation to remove a job or jobs from printer#!. 

Line 61: 

talias sd 'screendump | rastrepl | Ipr -v &' 

Abbreviation to print the contents of the Workstation screen. 

Line 62: 

#alias edit textedit 

Abbreviation for the window-system text editor. 

Line 63: 

#alias help man 

Another name for the man command. 

Line 64: 

#alias key 'man -k' 

Abbreviation for the man -k command (same as the what i s command 
described in Doing More with SunOS: Beginner’s Guide). 

Line 65: 

#alias mkae make 

Useful if you tend to misspell the word “make.” 
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The C Shell and the .login File 


When you log in, after performing instructions in the . cshr c file, the C shell 
then performs instructions in the . login file. Subsequent C shells, such as 
those running within terminal (shelltool) windows, ignore the . login file. 

Like the . cshrc file, you can include any command that you might type in on 
the command line. However, we recommend that you use the . login file for 
initializing remote terminals (for when you log in by phone), starting your win¬ 
dow system (when you first log in to the workstation), and setting up special vari¬ 
ables called environment variables. Unlike shell variables, environment vari¬ 
ables are passed along to subsequent commands and programs automatically. 

You need not set them up again every time you start a new C shell or run a new 
program such as vi. 

Environment variables are useful for storing information that aH programs need 
to know about. For instance, many commands and programs need to know what 
type of terminal you are using. This information is stored in the TERM environ¬ 
ment variable. Commands that send output to the printer need to know which 
printer to send their output to. You can use the PRINTER environment variable, 
to store the name of a printer to use by default. 

To set an environment variable, use the setenv command. This command has 
two required arguments, the name of the variable, and its value. 

setenv name value 

For example 

Figure 3-1 The seten-v Command 


venxis% sete 

nv PRINTER Iw 




j 


Although not required, the convention is to use aU capitals for names of environ¬ 
ment variables (to distinguish them from ordinary shell variables). To see what 
environment variables are currently in effect, use the printenv command: 
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Figure 3-2 The printenv Command 
. ^ __ 

venus% prlntanv ' . • . . 

HOME^/liome / sam 
SHELlr^/bin/csh 

PATH*-:/home/sam:/home/sam/bin:/usr/localt/usr/uob:/usr/bin j/b±n 

TERM-gun 

USER=sani 

EOITOR“/usr/ucb/vi . ■■ •• •. : • 

PRIHTER=lw ■ • • ■■■, 

WINDOW_PARENT=/dev/winO 

WMGR._ENV_PLACEHOLDER=/dev/winl-. 

WJNDOW_ME*/dev/win9 ■ ■ . 

WI NDOW^fjFX*/dev/w in 9 

I_^_J 


To remove an environment variable, use the unsetenv command; 


Figure 3-3 unsetenv 


r 

. .. .A 

venus% unsetenv PRINTER 


venu 5 % echo $PRINTER 

PRINTER: Undefined variable. 


V-_... 

J 


3.1. A Sample . login The following pages contain an annotated listing of the sample . login file 

File located in /usr/lib/Login. If you do not plan to log in from a remote ter¬ 

minal over the phone, you can delete the lines that pertain to remote terminals. 
Again, some commands are commented out And again, we recommend that you 
delete commands that do not pertain to you. 
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################################################################## 

# 

# .login file 

# 

# Read in after the .cshrc file when you log in. 

# Not read in for subsequent shells. For setting up 

# terminal and global environment characteristics. 

# 

################################################################## 


# terminal characteristics for remote terminals: 


# Leave lines for all but your remote terminal commented 

# out (or add a new line if your terminal does not appear). 

if ($TERM != ”sun") then 1 

#eval 'tset -sQ -m dialup:?925 -m switch:?925 -m dumb:7925 $TERM' 2 

#eval 'tset -”SQ -m dialup: ?hl9 ~m switch: ?hl9 -m dumb:?hl9 $TERM' 3 

#eval 'tset -sQ -m dialup:?mac -m switch:?mac -m dumb:?mac $TERM' 4 

#eval 'tset -sQ ~m dialup:?vtl00 -m switch:?vtl00 -m dumb:?vtl00 $TERM' 5 

#eval 'tset -sQ -m dialup:?wyse“nk -m switch:?wyse-nk -m dumb:?wyse-nk $TERM' 6 

#eval 'tset -sQ -m dialup:Twyse-vp -m switch:Twyse-vp -m dumb:?wyse-vp $TERM' 7 

endif ^ 8 

# general terminal characteristics 

#stty -crterase 9 

#stty -tabs lo 

#stty crt 11 

#stty erase ' "h' n 

#stty werase b 

#stty kill ' " 24 

#stty new 15 

# environment variables 

fsetenv EXINIT 'set sh=/bin/csh sw=4 ai report=2' 16 

setenv MORE '-c' 17 

#setenv PRINTER Iw 18 

# commands to perform at login 

#w 19 

if ("'tty'” != "/dev/console") exit 20 

echo -n "SunView? (^C to interrupt) " 2i 

sleep 5 22 

sunview 23 
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Explanation of Command Line 1: 

if ($TERM != "sun") then 

Perform the commands between this line and the endif line only when log¬ 
ging in on a terminal, rather than a Sun Workstation. 

Line 2: 

#eval 'tset -sQ -m dialup:?925 -m switch:7925 -m dumb:7925 $TERM' 

If logging in over a phone line, or some other remote means, set up terminal 
characteristics for a Televideo 925 terminal and place these characteristics in 
the environment for faster startup of interactive programs. Asks if terminal 
type 925 is correct by prompting you with 

TERM 925 

Pressing f Return I accepts the 925 as the terminal type; or you can enter 
another terminal type (from /etc/t ermcap). Refer to tset in the 
SunOS Reference Manual for more information. 

All of the lines pertaining to specific types are commented out To activate 
the line that pertains to your terminal, remove the pound-sign. If your termi¬ 
nal does not appear, duplicate this line, change the 92 5 to the name of your 
terminal (see your System Administrator for this information) and remove 
the pound-sign. 

Line 3: 

teval 'tset -sQ -m dialup:7hl9 -m switch:7hl9 -m dumb:7hl9 $TERM' 

Set up terminal characteristics for a Heathkit H19 terminal. 

Line 4: 

teval 'tset -sQ -m dialup :7mac -m switch :7mac -m duitib:7mac $TERM' 

Set up tenninal characteristics for a Macintosh running Macterminal. 

Line 5: 

teval 'tset -sQ -m dialup:7vtl00 -m switch:7vtl00 -m diamb:7vtl00 $TERM' 

Set up terminal characteristics for a VTKX) tenninal. 

Line 6: 

teval 'tset -sQ -m dialup:7wyse-nk -m switch:7wyse-nk -m dumb:7wyse-nk $TERM' 

Set up terminal characteristics for a Wyse 50 terminal. 

Line 7: 

teval 'tset -sQ -m dialup:7wyse-vp -m switch:7wyse-vp -m dumb:7wyse-vp $TERM' 
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Set up terminal characteristics for a Wyse 50 in ADDS Viewpoint mode 
with "enhance" turned on. 

Line 8: 

endif 

Marks last line to be skipped when an if ... then statement is found to 
be false; in this case, when logging in to a Sun Workstation directly (or from 
another Sun on the network). 

Line 9: 

#stty -crterase 

Set up the erase function to backspace without blotting out erased characters. 
Erased characters remain visible on the screen until you overwrite them with 
new ones, but are not transmitted to the C shell when you press I Return) . 

Line 10: 

#stty -tabs 

Convert tabs to spaces when displayed on the screen. 

Line 11: 

#stty crt 

Set up standard CRT characteristics. 

Line 12: 

#stty erase ' "h' 

Set the erase character to I Back Space I . Note that with stty, control char¬ 
acters are indicated by the two-character symbol circumflex-character, "c. 

Line 13: 

#stty werase ' ' 7 ' 

Set the erase-word character to I Del 1 . 

Line 14: 

#stty kill '~ 

Set line kill character to I Esc I . 

Line 15: 

#stty new 

Use the new version of the terminal driver. 

Line 16: 
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fsetenv EXINIT 'set sh=/bin/csh sw=4 ai report=2' 

Another way to set up options for vi. If you use the EXINIT environment 
variable, vi ignores your . exrc file.^ 

Line 17: 

setenv MORE '-c' 

Sets up more to overwrite the screen rather than scrolling. This makes 
reading more output much easier. 

Line 18: 

isetenv PRINTER Iw 

Indicate which printer is to receive jobs by default. 

Line 19: 

#w # see who is logged in 

See who is logged in on your system. 

Line 20: 

if ("'tty'" != "/dev/console") exit 

If the terminal is not your Workstation console (the Workstation when not 
running the Window-system), then stop further processing of this file. 

Line 21: 

echo -n "Sunview? ("C to interrupt) " 

Warn you that SunView is about to start. 

Line 22: 
sleep 5 

Wait 5 seconds before starting Sunview, to give you a chance to press 
(Ctrl-C I . 

Line 23: 

sunview 

Start the window system. 


^ If exrc doesn’t exist in the current directory. 
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The C Shell and the . logout File 


When you log out completely (not just from a single window), the C shell per- 
fomis instructions in the . logout file. This file is useful for running house¬ 
keeping type commands in the background while you are away. 

Like . cshrc and . login you can include any command that you might type 
in on the C shell command line. We recommend that you use this file only for 
displaying information about the session just ending that you want to know 
about, and running background commands. You should not put commands that 
run interactively in this file, nor should you include commands that take any 
significant amount of time unless the command runs in the background. Other¬ 
wise someone may be able to interrupt the command and gain unauthorized 
access to your workstation or terminal. 

4.1. A Sample . logout The following pages contain an annotated listing of the sample . logout file 
File located in/usr/lib/Logout. Some commands are commented out, and we 

recommend that you delete commands that do not pertain to you. 
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############################################################ 

# 

# .logout file 

# I 

# Read in when you exit from the login shell. j 

# For performing housekeeping while your are away. | 

# 

############################################################ 


clear l 
#echo "'hostname': 'whoami' logged out at 'date'" 2 
#echo "GoodbyeX!" 3 

#if (-e /usr/games/fortune) /usr/games/fortune -a 4 
#if (-r /etc/motd) cat /etc/motd 5 

tunalias rm 6 
#nice find ~ ' -name core -o -name -o -name '*.CKP' \ 7 
# -o -name '#*' -o -name junk ')' \ 


# -atime +3 -mtime +3 -user $USER -type f -exec \rm '{}' \; & 
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Explanation of Command 
Lines 


Line 1: 
clear 

Clears the terminal screen. 

Line 2: 

#echo "'hostname': 'whoami' logged out at 'date'" 

Displays the name of the host machine, your user name, and the date and 
time you logged out. 

Line 3: 

#echo "Goodbye\!" 

A more traditional parting wish. 

Line 4: 

#if (-e /usr/games/fortune) /usr/games/fortune -a 

If the fortune command is available, use it to display one of many 
humorous sayings. 

Line 5: 

#if (-r /etc/motd) cat /etc/motd 

If the message of the day is readable, display it. 

Line 6: 

funalias rm 

If you used alias to change the rm command in some way, this resets it 
to its original, default value. 

Line 7: 

#nice find ~ -name core -o -name '*.BAK' -o -name '*.CKP' \ 

# -o -name '#*' -o -name junk ')' \ 

# -atime +3 -mtime +3 -user $USER -type f -exec \rm '{]' 

Run find at low priority in the background, starting with your home direc¬ 
tory. Look for files named core, * . BAK, * . CKP, ' #*' or junk. Of 
these, select only those that are at least 3 days old, haven’t been modified for 
at least 3 days, belong to you, and are regular files (not directories). Remove 
each file selected, escaping any aliases that might be applied to rm. 

To activate this command, you need to delete the first pound-sign in all three 
lines. 


®sun 

microsystems 


Revision A of 9 May 1988 


















5 


vi and the . exrc File 


Whenever you run vi, the editor looks in the . exrc file for initial commands 
and option settings. The vi editor has a number of options that are described in 
detail in Editing Text Files, vi has a : set command with which you select the 
editing options that you want, but you cannot use it to create new variables, as 
you can with the C shell’s set command. 

5.1. Setting Options While To see the list of options that are currently in effect, type in : set with no argu- 
in vi ments: 

Figure 5-1 Using set to See Current Options 



To see the list of all possible settings, use the : set all command: 
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Figure 5-2 


Using set all 


: seit all 



all 



autoindent 

open 

tabstop®8 

autoprint 

nooptimize 

taglength=0 

noautowrite 

prompt 

tagstack 

beautify 

noreadonly 

term=5un 

direototy«/tmp 

redraw 

noterse 

noedcompatible 

remap 

timeout 

noerrorbells 

report*5 

tty types'! sun 

haxdtabs~8 

scroll-16 

warn 

noignorecase 

shell-/bin/c sh 

window-33 

nolisp 

shiftwidth^S 

wrapscan 

nolist 

noshowmatch 

wrapmargin-8 

magic 

noslowopen 

nowriteany 

nonumber 



[Hit return to continue 1 



To select a specific option or options, include them as arguments to the : set 
command. Note that for options having values, there are no spaces between the 
name, the equal-sign, and the value for that option. When the value for an option 
includes spaces, such as that for sections above, the space is escaped with a 
backslash within the command: 

:set sections=NHSHH\ HUnhsh 


To turn off an option, add the prefix no to the name of that option as an argu¬ 
ment to : set. 


Figure 5-3 Viewing Options 


: set 


iautoindent beautify nomesq number redraw term=sun wrapmarain=8 | 


c . J 


Figure 5-4 Turning an Option Off 





:set noautoindent 



:set 



tbeautifv nomesg number;:red 

raw term-sun wrapmargin-S j 


V.. 




To change the value of a setting such as wrapmargin, use set to establish a 
new value: 

:set wrapmargin=0 


(This has the effect of eliminating automatic wrapping at the end of the line). 
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5.2. A Sample . exrc File The following page contains an annotated listing of the sample . exrc file 

located in/usr/lib/Exrc. Since vi does not accept comments as with the 
C shell, there are no lines commented out. So, you may wish to delete aU lines 
starting with : map, and add them (or others like them) when you have read 
thiovi^ Editing Text Files. 
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n 


set 

autoindent 

1 

set 

autoprint 

2 

set 

noignorecase 

3 

set 

nomesg 

4 

set 

noslowopen 

5 

set 

noterse 

6 

set 

If 

nonumber 

7 

set 

report=2 

8 

set 

tabstop=8 

9 

set 

II 

wrapmargin=8 

10 

map 


11 

map 

g :% 

12 

map 

V ■ 

13 

map 

m !} fmt -c 

14 

map 

T !} sort 

15 


If 
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Explanation of Command 
Lines 


Line 1: 

set autoindent 

When adding new lines, maintain the same indentation as the line above. 
Line!: 

set autoprint 

Automatically print each line altered within ex, the line editor. 

Line 3: 

set noignorecase 

The case (upper or lower) of a character is significant in searches and substi¬ 
tutions. Use set ignorecase to make searches and substitutions case 
insensitive. But be careful if you do! 

Line 4: 

set nomesg 

Messages to the terminal do not interfere with the vi display. 

Line 5; 

set noslowopen 

Sets up vi for operation with a fast terminal or window. For terminals on 
slow dialup lines, use set slowopen to suspend updates of the screen 
during insertions for smoother operation. 

Line 6: 

set noterse 

vi gives more complete error messages for beginning users. For shorter 
messages, use set terse. 

Line 7: 

set nonumber 

Inhibits display of line numbers in both ex and vi. For a display of line 
numbers, use set number. 

Line 8: 

set report=2 

Report on all substitutions or deletions that affect more than two lines. 

Line 9: 

set tabstop=8 
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Set tab stops every 8 characters. 

Line 10: 

set wrapniargin=8 

When a space is typed within 8 characters of the right screen edge, insert a 
carriage-return at the end of the previous word, starting a new line automati¬ 
cally. 

Line 11: 

map ; : 

While in vi command (visual) mode, interpret a semicolon as if you had 
typed a colon. This allows you to use either a semicolon or a colon as the 
first character in a substitution command. 

Line 12: 

map g :% 

While in visual mode, interpret a g as if you typed the characters ; %. This 
allows you to start commands to substitute throughout the file with either a g 
ora :%. 

Line 13: 

map V - 

While in visual mode, interpret a v as if you typed a ~, the command to 
invert the case of a character. 

Line 14: 

map m ! } fmt -c 

While in visual mode, interpret an m as if you typed in the command 
!} fmt -c 

to adjust line-breaks for the lines between the cursor and the end of the para¬ 
graph as close to column 80 as possible (without breaking across words). 
Refer to Editing Text Files and fmt in the SunOS Reference Manual for 
more information. 

Line 15: 

map T !} sort 

While in visual mode, interpret a T as if you typed in the command 

! } sort 

a command to sort the remaining lines in the paragraph. 
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M 
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p 
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PRINTER environment variable, 32 

R 

rc suffix, explained, 11 
reprint terminal function, 6 

s 

set command, 11 
: set command (vi), 41 
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setup file, 4 

command to list, 4 
setup for remote terminals, 30 
shell, name for a command interpreter, 3 
stop display terminal function, 6 
stty and the circumflex, 6 
stty command, 5 
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suspend terminal function, 6 

T 

terminal functions, 5 
tset command, 30 

u 

unset command, 11 
unsetting a vi variable, 42 

V 

variables, environment, 27 
vi editor, 3 

w 

wait-for-keystroke terminal function, 6 
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